package com.nidu.demo.role.gateway;

import com.alibaba.cola.dto.PageResponse;
import com.nidu.demo.role.model.Role;
import com.nidu.demo.role.model.RoleCriteria;

import java.util.Set;
import java.util.List;

/**
 * 角色网关接口
 * 供领域层调用，实现跨上下文/基础设施的角色数据访问
 *
 * @author auto
 */
public interface RoleGateway {

    /**
     * 创建角色
     *
     * @param role 角色信息
     * @return 创建后的角色
     */
    Role create(Role role);

    /**
     * 更新角色
     *
     * @param role 角色信息
     * @return 更新后的角色
     */
    Role update(Role role);

    /**
     * 删除单个角色
     * @param id 角色ID
     */
    void deleteById(Long id);

    /**
     * 批量删除角色
     * @param ids 角色ID列表
     */
    void deleteByIds(Set<Long> ids);

    /**
     * 根据角色ID查询
     * @param id 角色ID
     * @return 角色信息
     */
    Role getById(Long id);

    /**
     * 根据角色ID列表查询
     * @param ids 角色ID列表
     * @return 角色列表
     */
    List<Role> getByIds(Set<Long> ids);

    /**
     * 根据角色编码查询
     * @param code 角色编码
     * @return 角色信息
     */
    Role getByCode(String code);

    /**
     * 列表查询
     * @param criteria 查询条件
     * @return 角色列表
     */
    List<Role> listByCondition(RoleCriteria criteria);

    /**
     * 分页查询
     * @param criteria 查询条件
     * @return 分页结果
     */
    PageResponse<Role> pageByCondition(RoleCriteria criteria);

    /**
     * 更新角色状态
     * @param id 角色ID
     * @param status 状态值
     */
    void updateStatus(Long id, Integer status);
}